org.globalplatform
Interface Application

All Superinterfaces:

javacard.framework.Shareable

public interface Application
extends javacard.framework.Shareable

This interface defines a method through which an Application may forward input data to another Application.

This interface shall be implemented by an Application that wishes to receive personalization data forwarded by its associated Security Domain. In such a scenario, if the Application implements both the Application and the Personalization interface, then the Security Domain shall use the Personalization interface.

Since:

export file version 1.0

See Also:

Personalization

Method Summary

void	processData(byte[] baBuffer, short sOffset, short sLength) Processes application specific data received from another on-card entity.

Method Detail

processData

void processData(byte[] baBuffer,
                 short sOffset,
                 short sLength)

Processes application specific data received from another on-card entity.

If the Application invoking this method is a Security Domain then it shall be assumed that:

• The baBuffer byte array is a global byte array;
• The data forwarded by the Security Domain is a STORE DATA command. The sOffset parameter locates the class byte of the command and the sLength parameter indicates the length of the entire command (i.e. header + data field).
• Any exception thrown by this method will be rethrown by the Security Domain, hence will be converted to and returned as a response status word to the off-card entity. If the exception is an ISOException, then the status word will be the reason code of that exception. Otherwise, a status word of '6F00' will be returned.

Notes:

• Upon invocation of this method, the Java Card VM performs a context switch.
• As the Application is not the currently selected Application, it should not attempt to access transient memory of type CLEAR_ON_DESELECT during the processing of this method.
• The Application is responsible for managing the atomic modification of its own data, if needed.
• As this method may be invoked by a Security Domain immaterial of the Application's internal state, the Application is responsible for ensuring that its internal state is valid for this operation.

Parameters:

baBuffer - byte array containing input data. Must be a global byte array.

sOffset - offset of input data within baBuffer.

sLength - length of input data.

Throws:

java.lang.SecurityException - if baBuffer is not a global byte array.

java.lang.NullPointerException - if baBuffer is null.

java.lang.ArrayIndexOutOfBoundsException - if reading input data would cause access of data outside array bounds.